home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 476-500 / disk_497 / windowshuffle / fensterln.dok < prev    next >
Text File  |  1992-05-06  |  12KB  |  297 lines
  1.  
  2.                               Fensterln
  3.  
  4.                              (Commodity)
  5.  
  6.                                  von
  7.  
  8.                             Stefan Sticht
  9.  
  10.           Dieses Programm, Quellcode und Dokumentation sind
  11.  
  12.                             PUBLIC DOMAIN.
  13.  
  14.  
  15.                Sie können damit machen, was Sie wollen!
  16.  
  17.  
  18. Der Zweck dieses Commodities:
  19. -----------------------------
  20. Mit   diesem  Commodity  können  Sie  die  folgenden  vier  Funktionen
  21. beliebigen Tasten zuweisen:
  22.  
  23.     nächstes Fenster aktivieren
  24.     vorheriges Fenster aktivieren
  25.     nächstes Fenster aktivieren und vor alle anderen bringen
  26.     vorheriges Fenster aktivieren und vor alle anderen bringen
  27.  
  28. Damit können Sie dann durch die Fenster eines Bildschirmes "wandern".
  29. Zusätzlich  können Sie verschiedene Fenster vor den Aktionen bewahren,
  30. indem  Sie  verschiedene Fenstertitel aufzählen.  Sogenannte Backdrop-
  31. Fenster  (Hintergrundfenster) können vor dem Aktivieren bewahrt werden
  32. und titellose Fenster können ebenso vor den Aktionen geschützt werden.
  33.  
  34. Systemanforderungen:
  35. --------------------
  36. Dieses  Commodity  erfordert mindestens Kickstart 37.#?  und Workbench
  37. 37.#?.  Bitte prüfen Sie dies, indem Sie in der Shell Version eingeben
  38. oder  im  Workbench  Menü  About  aufrufen.   Außerdem  muß  sich  die
  39. commodities.library  in Ihrem Verzeichnis libs:  befinden.  Überprüfen
  40. Sie  dies  bitte,  indem  Sie  in  der  Shell  den  Befehl "dir libs:"
  41. eingeben.
  42.  
  43. Und so startet man ein Commodity:
  44. ---------------------------------
  45. Es  gibt  grundsätzlich  zwei  verschiedene  Arten,  ein  Commodity zu
  46. starten:  von der Workbench oder von der Shell aus.
  47.     Das Starten von der Workbench aus ist äußerst einfach:  Machen Sie
  48. einen  Doppelklick  auf  dessen Icon und das Commodity wird gestartet.
  49. Eventuell  wollen  Sie verschiedene Parameter eines Commoditys ändern.
  50. Dazu  benutzen  Sie  Tool-Types.  Tool-Types ändern Sie, indem Sie das
  51. Commodity  Icon einmal anklicken und im Menü der Workbench Information
  52. aufrufen.   In  dem  Fenster, daß sich öffnet, sehen Sie die Liste der
  53. Tool-Types.   Wie  Sie die Tool-Types ändern, lesen Sie bitte in Ihrer
  54. Workbench-Dokumentation   nach.    Welche  Parameter  Sie  für  dieses
  55. Commodity ändern können, wird später beschrieben.
  56.     Bitte  beachten Sie, daß ein weiterer Doppelklick auf das Icon des
  57. Commoditys,  während  es  bereits  läuft,  bewirkt,  daß das Commodity
  58. beendet  wird.   Da  es nicht sinnvoll wäre, ein Commodity zweimal zur
  59. gleichen Zeit laufen zu lassen, ist dies auch nicht möglich.
  60.     Um  ein  Commodity in der Shell zu starten, geben Sie dessen Namen
  61. ein.   Sollten  Sie  die Fehlermeldung "Unknown command ???" erhalten,
  62. haben  Sie  sich  beim  Commodity-Namen  vertippt  oder  das Commodity
  63. befindet sich nicht in ihrem aktuellen Verzeichnis bzw.  dem aktuellen
  64. Suchpfad.    Am   einfachsten   ist   es,   das  aktuelle  Verzeichnis
  65. mit dem Befehl "CD" dorthin zu ändern, wo das Commodity sich befindet.
  66. Sie  können  die Parameter eines Commodity mit Befehlsoptionen ändern.
  67. Die  verfügbaren  Optionen  können Sie sich anzeigen lassen, indem Sie
  68. ein ?  als ersten Parameter angeben:
  69.  
  70.                              Fensterln ?
  71.  
  72. gibt Ihnen eine Liste der Befehlsoptionen.  Die Erklärung jeder Option
  73. erfolgt  später.  Startet man das Commodity, während es bereits läuft,
  74. erreicht man wiederum, daß es beendet wird.
  75.  
  76.     Wenn  Sie  wünschen,  daß  das  Commodity  bei  jedem Boot-Vorgang
  77. gestartet  wird, sollten Sie folgende Zeile in Ihre User-Startup Datei
  78. einfügen:
  79.  
  80.                        <Pfad>Fensterln <Optionen>
  81.  
  82. Vergessen  Sie  bitte  nicht  für  <Pfad>  den  tatsächlichen Pfad zum
  83. Commodity   und   für   <Optionen>   die  gewünschten  Befehlsoptionen
  84. anzugeben.   Folgendes  Beispiel  startet  Fensterln,  wenn es sich im
  85. Schubladen Tools der Boot-Diskette befindet:
  86.  
  87.                            Tools/Fensterln
  88.  
  89.     Eine  andere  Möglichkeit,  um  das  Commodity bei jedem Booten zu
  90. starten,  ist,  das  Icon  von Mausweg in den Schubladen WBStartup der
  91. Boot-Diskette   (Workbench)   zu   verschieben.   Das  Commodity  wird
  92. dann   bei   jedem   Boot-Vorgang  gestartet,  als  hätten  Sie  einen
  93. Doppelklick  auf das Icon durchgeführt.  Allerdings müssen Sie im Icon
  94. das Tool-Type DONOTWAIT ergänzen.
  95.  
  96. Benutzung von Exchange:
  97. -----------------------
  98. Exchange  ist  das  Programm,  mit  dem  Commodities verwaltet werden.
  99. Starten  Sie Exchange, das sich für gewöhnlich im Utilities Schubladen
  100. Ihrer  Boot-Diskette  befindet, mit einem Doppelklick auf dessen Icon.
  101. Es  wird Ihnen nun eine Liste aller verfügbaren Commodities angezeigt,
  102. aus  der  Sie  das  entsprechende  Commodity  auswählen können.  Unter
  103. dieser  Liste  wird  nach  Auswahl eines Commodities automatisch desen
  104. Titel, Beschreibung und Status angezeigt.
  105.     Sie   können   nun   Commodities   völlig   beenden   mit  "Kill",
  106. vorübergehend  ausschalten  mit  "Disable"  und wieder einschalten mit
  107. "Enable".   Wenn  das  Commodity  ein  Fenster  öffnen kann, indem für
  108. gewöhnlich Parameter eingestellt werden, können Sie dieses Fenster mit
  109. "Show" öffnen lassen und mit "Hide" schließen lassen.
  110.  
  111.  
  112.                        Veränderbare Parameter:
  113.                        -----------------------
  114.  
  115. CX_Priority:
  116. ------------
  117. Mit  dem  Tool-Type  oder der Befehlsoption CX_PRIORITY=<p> können Sie
  118. die  Priorität  des  Commodities  innerhalb  der Liste der Commodities
  119. bestimmen.   Setzen  Sie  für <p> bitte einen positiven dezimalen Wert
  120. ein. Die voreingestellte Priorität ist 0.
  121.  
  122. NEXT_ACTIVE:
  123. ------------
  124. Mit dem Tool-Type oder der Befehlsoption NEXT_ACTIVE=<Eingabebeschrei-
  125. bung>  bestimmen  Sie die Taste, mit der daß nächste Fenster aktiviert
  126. werden  soll.   <Eingabebeschreibung> ist eine Eingabebeschreibung wie
  127. sie  weiter  unten erläutert werden.  Voreingestellt ist "NEXT_ACTIVE=
  128. lcommand lshift k" (linke Amigataste & like Shifttaste & k).
  129.  
  130. PREV_ACTIVE:
  131. ------------
  132. Mit dem Tool-Type oder der Befehlsoption PREV_ACTIVE=<Eingabebeschrei-
  133. bung>  bestimmen  Sie  die  Taste,  mit  der daß vorhergehende Fenster
  134. aktiviert   werden  soll.   <Eingabebeschreibung>  ist  eine  Eingabe-
  135. beschreibung  wie  sie  weiter unten erläutert werden.  Voreingestellt
  136. ist   "PREV_ACTIVE=lcommand   lshift   j"  (linke  Amigataste  &  like
  137. Shifttaste & j).
  138.  
  139. NEXT_BOTH:
  140. ----------
  141. Mit  dem  Tool-Type oder der Befehlsoption NEXT_BOTH=<Eingabebeschrei-
  142. bung>  bestimmen  Sie die Taste, mit der daß nächste Fenster aktiviert
  143. und  in  den  Vordergrund gebracht werden soll.  <Eingabebeschreibung>
  144. ist  eine  Eingabebeschreibung  wie sie weiter unten erläutert werden.
  145. Voreingestellt ist "NEXT_BOTH=lcommand k" (linke Amigataste & k).
  146.  
  147. PREV_BOTH:
  148. ----------
  149. Mit  dem  Tool-Type oder der Befehlsoption PREV_BOTH=<Eingabebeschrei-
  150. bung>  bestimmen  Sie  die  Taste,  mit  der daß vorhergehende Fenster
  151. aktiviert  und  in  den  Vordergrund  gebracht werden soll.  <Eingabe-
  152. beschreibung>  ist  eine  Eingabebeschreibung  wie  sie  weiter  unten
  153. erläutert  werden.   Voreingestellt  ist "PREV_BOTH=lcommand j" (linke
  154. Amigataste & j).
  155.  
  156. BACKDROP:
  157. ---------
  158. Mit  dem  Tool-Type oder der Befehlsoption BACKDROP=JA|NEIN können Sie
  159. wählen,  ob sogenannte Backdrop-Fenster (Hintergrundfenster) aktiviert
  160. werden sollen.  JA|NEIN bedeutet, daß Sie zwischen JA oder NEIN wählen
  161. können.   JA  bedeutet,  daß Backdrop-Fenster aktiviert werden sollen.
  162. Voreingestellt ist NEIN.  Backdrop-Fenster können nicht nach vorne ge-
  163. bracht werden.  Fensterln versucht dieses auch gar nicht erst.
  164.  
  165. OHNETITEL:
  166. ----------
  167. Mit  dem Tool-Type oder der Befehlsoption OHNETITEL=JA|NEIN können Sie
  168. wählen,  ob  Fenster  ohne  Titel aktiviert und/oder nach vorne geholt
  169. werden  sollen.  JA|NEIEN bedeutet wieder JA oder NEIN.  Mit JA werden
  170. auch solche Fenster aktiviert bzw.  nach vorne geholt.  Voreingestellt
  171. ist NEIN.
  172.  
  173. DIESENICHT:
  174. -----------
  175. Mit  dem  Tool-Type  oder der Befehlsoption DIESENICHT=<Jokerausdruck>
  176. können   Sie  verhindern,  daß  Fenster  mit  bestimmten  Titel  nicht
  177. aktiviert  bzw.  nach vorne gebracht werden.  <Jokerausdruck> ist eine
  178. Zeichenkette  mit  Jokern,  wie  AmigaDOS  Sie kennt.  Sie können alle
  179. Standard-  AmigaDOS-Joker  benutzen,  die Sie z.B.  bei "dir" benutzen
  180. können.   Stellen Sie sich nur vor, die Fenstertitel wären Dateinamen.
  181. Bitte sehen Sie in Ihrem AmigaDOS-Handbuch die genaue Beschreibung von
  182. Jokern nach.  Wichtig:  Groß- und Kleinschreibung wird unterschieden!
  183.  
  184. Beispiele:
  185.  
  186. Die folgenden Titel sollen ausgeschlossen werden:  "Workbench", "Uhr",
  187. und alle Disk-Fenster (Disk-Fenster haben alle die Schlüsselwörter
  188. "full", "free", und "use" inne):
  189.  
  190.             DIESENICHT=(Workbench|Clock|#?full#?free#?use)
  191.  
  192. Wenn Sie nur Fenster aktivieren wollen, die mit dem Namen "Shell"
  193. beginnen:
  194.  
  195.                         DIESENICHT=~(Shell#?)
  196.  
  197.  
  198. Wenn  Sie  nur  das  Workbench-Fenster nicht nach vorne bringen wollen
  199. (falls dieses kein Hintergrundfenster ist):
  200.  
  201.                          DIESENICHT=Workbench
  202.  
  203.  
  204.  
  205.  
  206.                         Eingabebeschreibungen
  207.                         ---------------------
  208.                      (input description strings)
  209.  
  210. Mit   Eingabebeschreibungen   können   Sie   fast  jede  Eingabeaktion
  211. beschreiben,  z.B.   die Aktion lshift f1.  Dies heißt, daß die Aktion
  212. das drücken der Taste F1 zusammen mit der linken Shift-Taste ist.  Bei
  213. diesem Commodity öffnet die Aktion das Fenster des Commoditys.
  214.  
  215. Eingabebeschreibungen haben folgendes Muster:
  216.       [class] (([-]qual)|syn)* [[-]upstroke] [highmap|ANSIcode]
  217.  
  218. (* bedeutet keine oder mehrere Vorkommen des Ausdrucks in Klammern)
  219.  
  220. class   ("Klasse") ist einer der folgenden Ausdrücke:
  221.         rawkey, rawmouse, event, pointerpos, timer, newprefs,
  222.         diskremoved, diskinserted.
  223.         Wenn die Klasse nicht bestimmt wird, wird rawkey angenommen.
  224.  
  225. qual    (qualifier, "Qualifizierer") ist einer der folgenden Ausdrücke:
  226.         lshift, rshift, capslock, control, lalt, ralt, lcommand,
  227.         rcommand, numericpad, repeat, midbutton, rbutton, leftbutton,
  228.         relativemouse
  229.         Ein vorangestelltes "-" bedeutet, daß der folgende Qualifier
  230.         als irrelevant angenommen werden soll.
  231.  
  232. syn     ("Synonym") ist einer dieser Ausdrücke: shift, caps, alt
  233.         shift bedeutet linke oder rechte Shift-Taste
  234.         caps bedeutet Shift oder Caps-Lock
  235.         alt bedeutet linke oder rechte Alt-Taste
  236.  
  237. upstroke (wörtlich "upstroke")
  238.         Wenn dieser Ausdruck fehlt, zählt das Drücken einer Taste für
  239.         die Klassen rawmouse und rawkey. Wenn der Audruck vorhanden
  240.         ist, zählt das Loslassen einer Taste. Stellt man ein "-"
  241.         voran, so zählt beides.
  242.  
  243. highmap ist einer der folgenden Ausdrücke:
  244.         comma, space, backspace, tab, enter, return, esc, del, up, down,
  245.         right, left, help, f1, f2, f3, f4, f5, f6, f7, f8, f9, f10,
  246.         0, 1, 2, 3, 4, 5, 6, 7, 8, 9, (, ), /, *, -, +
  247.  
  248. ansicode ein einzelnes Zeichen steht genau für die entsprechende
  249.         Taste
  250.  
  251.  
  252. Noch einige Beispiele:
  253. ----------------------
  254.  
  255. Die  voreingestellten  Werte  (nur um zu zeigen, wie diese spezifziert
  256. werden müßten):
  257.  
  258. Fensterln CX_PRIORITY=0 "NEXT_ACTIVATE=lcommand lshift k"
  259. "PREV_ACTIVATE=lcommand lshift j" "NEXT_BOTH=lcommand k" "PREV_BOTH=lcommand j"
  260. BACKDROP=NEIN OHNETITLE=NEIN
  261.  
  262. Voreingestellte Werte und nicht Titel "Workbench":
  263.  
  264. Fensterln DIESENICHT=Workbench
  265.  
  266. zusätzlich Disk-Fenster verweigern:
  267.  
  268. Fensterln DIESENICHT=(Workbench|#?full#?free#?use)
  269.  
  270. Nur alle Fenster, die ein "W" als ersten Buchstaben im Titel haben,
  271. aktivieren; rechte Amigataste und Cursortasten benutzen:
  272.  
  273. Fensterln "NEXT_ACTIVATE=rcommand rshift down"
  274. "PREV_ACTIVATE=rcommand rshift up" "NEXT_BOTH=rcommand down"
  275. "PREV_BOTH=rcommand up" DIESENICHT=~(W#?)
  276.  
  277.  
  278.  
  279.      Schicken Sie Fehlerreports, Erweiterungswünsche, Fragen und
  280.      -----------------------------------------------------------
  281.                            Geschenke(!) an:
  282.                            ----------------
  283.  
  284.                             Stefan Sticht
  285.                           Bibereckerweg 40a
  286.                            D-8390 Passau 18
  287.                                  FRG
  288.  
  289. oder (besser) an eine der folgenden EMail-Adressen:
  290. Internet: cbmvax.commodore.com!cbmehq!cbmger!edith!sticht@rutgers.EDU
  291.       or: IWSTICHT@ibm.rz.uni-passau.de
  292. Fido-Net: Stefan Sticht (2:242/16)
  293.  
  294. Bitte nennen Sie bei einem Fehlerreport auch die Versionsnummer.
  295. Diese erhalten Sie z.B. mit dem Befehl "Version":
  296.                      Version [<path>]<commodity>
  297.